home *** CD-ROM | disk | FTP | other *** search
/ Amiga Inside! / Amiga FD Inside (1995)(Ultramax).iso / berndspd / grafiktools / mugiff / mugiff.english < prev    next >
Text File  |  1993-05-09  |  19KB  |  428 lines
  1. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»«««««««««««««««««««««««««««««««««««««
  2. »»»»»»»»»»»»»                                                 «««««««««««««
  3. »»»»»»»»»»»»»»D o c u m e n t a t i o n   f o r   M U G i f f««««««««««««««
  4. »»»»»»»»»»»»»                                                 «««««««««««««
  5. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»«««««««««««««««««««««««««««««««««««««
  6.  
  7.                             © 1993 by Mark Rose
  8.  
  9.   THIS  PROGRAM  IS  MAILWARE.  THE COPYRIGHT AND ALL MEANS OF EXPLOITATION
  10. REMAIN  PROPERTY  OF  THE  AUTHOR.   IT  MAY  BE  FREELY DISTRIBUTED IF THE
  11. FOLLOWING REQUIREMENTS ARE MET:
  12.  
  13.   1. NO  MONEY MAY BE CHARGED FOR THE DISTRIBUTION OF THIS PROGRAM EXCEPT A
  14.      NOMINAL  FEE  FOR  EXPENSES.   THIS  FEE  MUST NOT EXCEED 5.- DM (FIVE
  15.      GERMAN  MARKS  IN  WHATEVER  CURRENCY).
  16.  
  17.   2. THE DOCUMENTATION (ENGLISH AND GERMAN), THE SOURCECODE, EXECUTABLE AND
  18.      ALL  OTHER  FILES OF THIS DISTRIBUTION REMAIN INTACT AND UNCHANGED AND
  19.      *MUST* BE DISTRIBUTED TOGETHER.
  20.  
  21.   3. THIS  PROGRAM  MUST NOT BE USED IN ANY COMMERCIAL WAY.  IF YOU WANT TO
  22.      USE  THIS PROGRAM IN ANY COMMERCIAL FORM PLEASE CONTACT THE AUTHOR AND
  23.      TERMS CAN BE NEGOTIATED.
  24.  
  25.   THE  AUTHOR  TAKES NO RESPONSIBILITY FOR ANY DAMAGE THAT RESULTS FROM THE
  26. USE OF THIS PROGRAM.
  27.  
  28.  
  29.   THE  AUTHOR  ESPECIALLY  ENCOURAGES  THE  INCLUSION  IN THE 'AMOK' (AMIGA
  30. MODULA  UND OBERON KLUB), 'FRED FISH AMIGA FREELY DISTRIBUTABLE LIBRARY'
  31. SERIES AND THE XPK-DISTRIBUTION.
  32.  
  33.  
  34. =_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=
  35.    Since in the last versions nobody had the 'grace' to drop me a single
  36.  line (even by EMail which does not cost anything) I changed the status of
  37.                               this program to
  38.  
  39.                               M A I L W A R E .
  40.  
  41.    This means that everybody who uses this program longer than a day is
  42.       REQUIRED to send me mail by any means. Otherwise he is a pirate
  43.                             (and a louse, too).
  44. =_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=_=
  45.  
  46.  
  47. What MUGiff is:
  48. »»»»»»»»»»»»»»»
  49.  
  50.   Yet another IFF-viewer. But... (see next section)
  51.  
  52.  
  53. Features:
  54. »»»»»»»»»
  55.  
  56.   - Displays just any ILBM imagineable (except nested IFFs)
  57.  
  58.   - KS  1.2,  1.3,  2.04,  3.0 compatible (including AGA-support)
  59.  
  60.   - Runs  on  ANY  Amiga (hopefully) thanks to IFF-library.  Tested on A500
  61.     (512Chip,512Fast)  KS1.2,  A2000C  (1MB  Chip,  4MB Fast16, 4MB Fast32)
  62.     68030/881 KS2.04/KS3.0, A500 (2.3MB Fast, Kick 2.0).
  63.  
  64.   - Can  display any number of pictures (under KS2.04, because of unlimited
  65.     commandline length)
  66.  
  67.   - XPK-support. XPKmaster.library must be installed though.
  68.  
  69.   - EXTREMELY SHORT! This version: 7024 bytes! (+ iff.library 3164 bytes)
  70.  
  71.   - Supports  OverScan (even under KS1.2/1.3).  This is done in a NOT KS2.0
  72.     way!  Works though ;)
  73.  
  74.   - IFF24bit  pictures  can  be  displayed.   Because  of  a  limitation in
  75.     IFF.library it is just the red part.  The only other way (as in ShowIFF
  76.     of  the  library)  would be to load the complete 24bit bitmap into CHIP
  77.     and 400×400 would be the limit (1meg CHIP).
  78.  
  79.   -   >>NEW SINCE 1.03<<
  80.     Pictures  larger  than  the  screen  can  be  scrolled without limiting
  81.     multitasking  at  all  (no  mousemovement, no CPU-time!  In contrast to
  82.     ShowIFF which calls GetMsg all the time).
  83.       >>NEW SINCE 1.04<<
  84.     The IDCMP-loop is done faster now, speeding scrolling up on 68000 based
  85.     Amigas (suggested by Thies Wellpott on Fish 771).
  86.  
  87.   -   >>NEW SINCE 1.06<<
  88.     MUGiff  now  invokes  the  ReqTools  FileRequester  when no argument is
  89.     supplied AND ReqTools has been installed.
  90.  
  91.   -   >>NEW SINCE 1.06<<
  92.     Several  bugs  were  removed (see 'History.DEF' for details) and MUGiff
  93.     now  runs  very reliable and stable on MY machine (well, I wrote it for
  94.     myself in the first place so this is the main feature...  ;^) )
  95.  
  96.   -   >>NEW SINCE 1.06<<
  97.     MUGiff  now comes with handdrawn Icons!  Why this?  Workbench usability
  98.     was greatly improved (e.g. ability to suppress annoying WB-window).
  99.  
  100.   -   >>NEW SINCE 1.09<<
  101.     MUGiff  now  supports MultiSelection!  Especially useful for disk-based
  102.     systems.  Select all the files you want and display them.
  103.  
  104.   -   >>NEW SINCE 1.10<<
  105.     Finally  the  ability to save uncompressed IFF-pictures has been added.
  106.     With  XPK  (HUFF 100%) you can save 2 up to 20KBytes.  Please note
  107.     that this version has MORE features but is SHORTER!
  108.  
  109.   -   >>NEW SINCE 1.11<<
  110.     Now  you can play animations!  You can even crunch your animations with
  111.     XPK!   Gives  much  better  results than PowerPacker AND MUGiff is 6000
  112.     bytes  shorter  than  PPShow  (though  not as feature packed)!  Combine
  113.     pictures  and  animations of any type and watch!  This version is again
  114.     SHORTER (550 Bytes!) than the previous!
  115.  
  116.   -   >>NEW SINCE 1.11<<
  117.     Tested with the new ENFORCER (Fish 800)! I couldn't find a single hit!
  118.  
  119.   -   >>NEW SINCE 1.12<<
  120.     Finally  verified  AGA-support!   Thanks  to  Jeff Hobbs for helping me
  121.     finding  the  AGA-bugs  (he was also the first and only one who sent me
  122.     mail  regarding MUGiff).  HAM8 and 256 color pictures can be pre-viewed
  123.     on non-AGA machines (in 16 colors but better than nothing).
  124.  
  125.  
  126. Known Features:
  127. »»»»»»»»»»»»»»»
  128.  
  129.   Oops! This should read Bugs of course... 8þ
  130.  
  131.   This  is a bug in iff.library:  Some XPK-packed EHB pictures are declared
  132. "non-iff"  by  the  OpenIFF routine.  I have exactly ONE picture that shows
  133. this  behaviour  (out  of  hundreds).  It is AnarchyDragon of the Party'92.
  134. Other crunched EHB-pictures just work fine... (BTW I use HUFF 100%)
  135.  
  136.   The  save  routine  (new since 1.10) has problems with EHB-pictures.  The
  137. colortable  seems  to  be  too short.  I couldn't locate this problem in my
  138. program (I just call SaveBitMap).  My guess is that iff.library looses some
  139. bytes when counting colors but this will be checked more thoroughly...
  140.  
  141.   MUGiff  seems  to loose some bytes of FastRam if used in conjunction with
  142. ReqTools.  The amount is exactly that of the FileList of ReqTools.  After a
  143. while  (some  program  calls)  the  memory  magically  reappears.   I  call
  144. 'FreeFileList'  for sure but it seems that ReqTools takes some time to free
  145. the memory.  So do not blame me for temporary memory losses!
  146.  
  147.  
  148. Installation:
  149. »»»»»»»»»»»»»
  150.  
  151.   Very  easy:  just copy the IFF.library and ReqTools.library (depending on
  152. the Kickstart version you have) to your LIBS:  directory (either by hand or
  153. using  the  provided scripts), put MUGiff somewhere in your path (e.g.  C:)
  154. and all the fun can begin...
  155.  
  156.   ReqTools  is  NOT explicitly needed by MUGiff (it checks for ReqTools V38
  157. and  if  it is not found it the FileRequester is disabled).  But if you use
  158. MUGiff  regularly  in  a  shell  environment or from Workbench I suggest to
  159. install ReqTools to save your poor little fingers...
  160.  
  161.                                »»»»»»»»»»»»»
  162.                                » REMEMBER: »
  163.                                »»»»»»»»»»»»»
  164.  
  165.                   IFF.library is © by Christian A. Weber
  166.                   ReqTools.library is © by Nico François
  167.  
  168.  
  169. Usage:
  170. »»»»»»
  171.  
  172.   CLI: Just start it  with the name(s) of the picture(s).
  173.   ----
  174.        Example: MUGiff DH0:IFFs/THEpic.IFF DF0:WoC.HAM RAM:Irving.face.ugly
  175.  
  176.          While displaying the picture you can scroll around using the mouse
  177.        (if  the  picture  is  larger  than  the  screen).  If more than one
  178.        picture  was  supplied  as argument you can display the next picture
  179.        with  the  left  mousebutton (or press any key) and abort the entire
  180.        display with the right mousebutton.
  181.  
  182.          Since  1.6  you  needn't  provide an argument at all.  This causes
  183.        MUGiff  to look for ReqTools.library.  If it can find the library it
  184.        will  open a FileRequester for you and (since 1.9) you can select as
  185.        many  files  as you want to.  Just hold down the SHIFT-key and click
  186.        on  the  files  you  want  to  view.   You  can also use the gadgets
  187.        provided  by the requester (which should be self-explanatory but for
  188.        full documentation see ReqTools.doc)
  189.  
  190.          A  new feature has been added since 1.10:  The ability to save the
  191.        currently  displayed  picture.   Just  press 's' and the old picture
  192.        will  be  overwritten  with  an  uncompressed  version  and the next
  193.        picture (if any) will be displayed.  This way you can convert MBytes
  194.        of  pictures  for  use  with  better  packers than RunLengthEncoding
  195.        (RLE).   ATTENTION:   see  the  section  'Known  Features' for a bug
  196.        occuring with EHB-pictures!
  197.  
  198.          Since  1.11  MUGiff  is also able to play animations (ANIM OPT 5)!
  199.        You  can  use the same selection methods as for pictures.  To finish
  200.        the  playback  press  CTRL  + C and the next file will be displayed.
  201.        You  can  mix animations and pictures any way you want to (ideal for
  202.        presentations).
  203.  
  204.   WB : 1. Make  MUGiff  the default-tool of your picture icon, double-click
  205.   ----    it and enjoy
  206.  
  207.        2. Via  extended  selection.   That is click on the MUGiff icon with
  208.           the  mouse and hold down the shift-key.  Then double-click on the
  209.           picture icon(s).  (and enjoy yourself THEN).
  210.  
  211.        3. If  you have ReqTools installed:  double-click on the MUGiff icon
  212.           and  a  FileRequester  will appear.  Choose your file(s) (Details
  213.           can be found in 'CLI'-section above).
  214.  
  215.          The  program  automatically  opens a window to display information
  216.        about  the  pictures  (resolution,  depth and wether it is an iff or
  217.        not).   If  this annoys you (especially the 'press >>RETURN<<') give
  218.        the  icon an ToolType entry "WINDOW=NIL:".  You can also specify the
  219.        dimensions of the window:
  220.  
  221.        "WINDOW=CON:0/0/1024/1024/ReallyBIGwindow/AUTO/CLOSE/MyPublicScreen"
  222.  
  223.        (the latter three for Kick 2.04 users only).
  224.  
  225.        See CLI (above) for more features and details...
  226.  
  227.  
  228. Hardcore Techno:
  229. »»»»»»»»»»»»»»»»
  230.  
  231.   This  program  was written to be as system-friendly as possible.  No busy
  232. loops  or  any  other  anti-multitasking  methods  are used.  All memory is
  233. dynamically  allocated.   All resources are freed (look at 'Known features'
  234. for details).  All references to bitmaps are via Screen^.rastPort.bitMap as
  235. suggested  by  C=  for  future  compatibility.  The screen-swapping for the
  236. animplayer is done by ScreenToFront and a WaitTOF for synchronization.
  237.  
  238.   The  annoying CTRL + C (at least for mousicians) was chosen because it is
  239. the  shortest  (in  code)  and  most  compatible way for request in a loop.
  240. GetMsg  would be no good because there can be messages even if the user did
  241. nothing  (refer  to  RKM:   Libraries  for  details).  A timer.device based
  242. asynchronous  routine  would be nice but I doubt it to be shorter and it is
  243. too  much  work just to test (yes, I AM lazy ;^) ).  If you want to you can
  244. implement it yourself and send it to me for release.
  245.  
  246.   MUGiff  is  intended to be as short a possible (and NOT using assembler),
  247. KS  1.2/1.3 compatible and to have all features that are not in contrast to
  248. the last two.
  249.  
  250.  
  251. Tips for using MUGiff:
  252. »»»»»»»»»»»»»»»»»»»»»»
  253.  
  254.   "Why doesn't this damned program support wildcards ???"
  255.  
  256.   Very  easy.   It  is designed to be used in such tools as Directory Opus,
  257. DiskMaster  or similar.  Put it in a gadget there and it will feel at home.
  258. This will also prevent that your fingers bleed due to too excessive typing.
  259.  
  260.   "I want MUGiff to have an AppIcon !"
  261.  
  262.   With the highest probability this will NEVER come true.  I do not need it
  263. and  as  egoistic  as I am I would never struggle to program something I do
  264. not have any use for.  But in the unexpected case that dozens of people cry
  265. for it...  (sigh, moan)
  266.  
  267.   "Why is there no FileRequester ?"
  268.  
  269.   Well, check your version of MUGiff.  Since 1.6 there it is:  the ReqTools
  270. FileRequester.  You must have installed ReqTools though. Since 1.9 there is
  271. also the possibility to select many files at the same time.
  272.  
  273.   "I would like to see the #? feature added"
  274.  
  275.   Patience.   First  try  reading  the next section for things to come.  If
  276. your  desires  are not met there just contact me ("how" is explained at the
  277. end  of  this  file).  If it is a feature I need myself you will find it in
  278. the  next  version.   If it is not more people should ask for it and I will
  279. implement it (sigh again).
  280.  
  281.   "MUGiff is desperately in need of a WYSIWYG editor, an art package (where
  282.    else  should  the  pictures  come from?), a Tetris-clone (preventing the
  283.    pictures  from  being  too boring), GameBoy(tm) implementation, 32768bit
  284.    Halfbrite-mode  (Kick  19.0) support and should become shorter (no space
  285.    on my WB-disk)."
  286.  
  287.   Exactly!   How  about a software 68040 emulator, that is able to simulate
  288. 16meg RAM on a stock A600 1MB and is 327% faster?         AAAARRRRGGGGHHHH!
  289.  
  290.  
  291. What will there be in future versions:
  292. »»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»»
  293.  
  294.   In order of probability:
  295.  
  296.   - This  is  probably  the  last  Modula-2  version.   Since my SAS/C copy
  297.     arrived  this  week  it  is just a matter of time when the port to C is
  298.     done.   But  first  I'll  have  to  work  through  hundreds of pages of
  299.     manual...
  300.     If you want to purchase M2Amiga 4.1d contact me! ];^}
  301.  
  302.   - PCHG-support.  You could finally crunch these fantastic pictures (which
  303.     are  also  fantastically  large)  with  XPK  and still view them!  This
  304.     feature has become more likely due to the availability of a C-compiler.
  305.  
  306.   - I cannot think of any more things to add. Tell me what you want.
  307.  
  308.  
  309. Bug-Reports:
  310. »»»»»»»»»»»»
  311.  
  312.   A  bug  in  one  of MY programs?  IMPOSSIBLE !!!  UNTHINKABLE !!!  But in
  313. case that perhaps despite that...
  314.  
  315.   Please  send  the reports to the address below.  EMail would be VERY nice
  316. because   of   the   mindboggling   speed.    Please  tell  me  your  exact
  317. configuration.   The  specifications  of  the  picture  and the kind of bug
  318. should  also be described with detail.  If possible send me the picture for
  319. testing (UUEncoded via EMail for example).
  320.  
  321.   If  this  documentation  contains  mistakes (grammatical and/or spelling)
  322. please  tell me so I can correct them.  You perhaps noticed that English is
  323. not my native tongue...
  324.  
  325.  
  326. Support:
  327. »»»»»»»»
  328.  
  329.   If you want to get the newest version faster than anyone else does do one
  330. of the following things (depending on where you live):
  331.  
  332.   Europe [that is the EEC]: Send  five  German  Marks to the address below.
  333.                             If  you  want  to use a different currency, add
  334.                             one  Mark  because  the  bank  likes to get its
  335.                             share... Use EuroCheques or cash (NO COINS!)
  336.  
  337.   Outside Europe [not EEC]: Send  five US-Dollars to the address below.  If
  338.                             you  can  get  your hands on a check drawn on a
  339.                             German bank, use it.  Otherwise please use cash
  340.                             only  (bank  fees  are too expensive, more than
  341.                             5DM anyway)
  342.  
  343.   It  would  be  very  kind if you would send a self-addressed envelope for
  344. easier  handling.   The  disk  is supplied by me and included in the price.
  345. This  disk  will  contain  the newest version of MUGiff (of course) and the
  346. newest distribution of XPK, IFF.library and ReqTools.
  347.  
  348.   As you can see the requested money has no margin for profit.  If you like
  349. MUGiff please remember this program is MailWare.  Thank You.
  350.  
  351.  
  352. How to contact me:
  353. »»»»»»»»»»»»»»»»»»
  354.  
  355.   There are many ways. Here they are in order of preference:
  356.  
  357.   - Via EMail    : ukkg@ibm3090.rz.uni-karlsruhe.de
  358.                                             »InterNet«         no UUEncoded
  359.                                             binaries! I cannot save mail to
  360.                                             disk there!
  361.  
  362.                    ukkg@dkauni2.bitnet      »BitNet« same as above
  363.  
  364.                    s_rose@iravcl.ira.uka.de »InterNet«if there are problems
  365.                                             to  contact  me   under   above
  366.                                             addresses [did happen!]
  367.  
  368. PLEASE  NOTE THAT UNTIL MID-APRIL I CANNOT ANSWER EMAIL BECAUSE OF ABSENCE.
  369. SNAIL MAIL TO MY OFFENBURG ADDRESS WILL REACH ME THOUGH.
  370.  
  371.   - Via Mailbox  : FidoNet: Mark Rose 2:241/7506.2 (Gio's Home)
  372.  
  373.   - Snail Mail   : Mark Rose                  Mark Rose
  374.                    Waldhornstr. 36, D604      Franz-Volk-Str. 37
  375.                    7500 Karlsruhe             7600 Offenburg
  376.                    GERMANY                    GERMANY
  377.                    (during Semester)          (you may always reach me there
  378.                                                but may take a while...)
  379.  
  380.  
  381. Acknowledgements:
  382. »»»»»»»»»»»»»»»»»
  383.  
  384.   Thanks to: Nico François for his great ReqTools.library
  385.  
  386.              Christian  Weber  for his IFF.library.  This one did save me a
  387.                LOT of work (especially porting some nested C-code...)
  388.  
  389.              Fred   Fish   for   providing  the  AMIGA-community  with  the
  390.                incredibly  good  AmigaLibDisks  which  served the community
  391.                better than every A4000!  Please continue your great work!
  392.  
  393.              the AMIGA for being the best computer in the world.
  394.  
  395.              Jeff Hobbs for being the first and only person who complied to
  396.              the  MAILWARE  status of this program and for being invaluable
  397.              in supporting AGA.
  398.  
  399.              Markus  Welte,  Heby,  Michael Renz and Andreas Krebs, my very
  400.              helpful ß-testers (and source of a lot of work ;^) ).
  401.  
  402.              Gio  for  maintaining  the  best  AMIGA-mailbox  (Gio's  Home)
  403.              possible.   You  can  always  get  the  most recent version of
  404.              MUGiff there.
  405.  
  406.  
  407.  
  408.  
  409. +-------------------------------------------------------------------------+
  410. |           T H I S   P R O G R A M   I S   M A I L W A R E  !            |
  411. +=========================================================================+
  412. |  Please remember: This program is MailWare.  If you like it and use it  |
  413. |   on a regular basis, think of the poor student who appreciates small   |
  414. |       amounts of mail that tell him how great/average/bad/&$§#?!*       |
  415. |   his program is. So  M A I L  me at once and have a clear conscience   |
  416. +-------------------------------------------------------------------------+
  417.  
  418.  
  419. ___________________________________________________________________________
  420.  ____   ONLY   ____  _____  ____
  421. | __ ||\    /||_  _|| ____|| __ |  "Harry : What do you recommend for a
  422. ||__||||\  //|  ||  || ___ ||__||           hangover?
  423. | __ |||\\//||  ||  |||___|| __ |   Annie : Teetotaling and prayer.
  424. ||  |||| \/ || _||_ ||___||||  ||   Cooper: Good answer.
  425. ||  ||||    |||____||_____|||  ||   Harry : I'll try some coffee."
  426.              makes it possible...                                Twin Peaks
  427. ___________________________________________________________________________
  428.